2018.3

Itential Automation Platform

On this page:

Upgrading

This page explains how to upgrade your software for the Itential Automation Platform (IAP).

Note: Major breaking changes to be aware of prior to upgrading your Itential software are fully described in the Product Notices section.

Prerequisites

Before upgrading:

  • Suspend all jobs through the Task Manager application.
  • Backup Mongo data and your /opt/pronghorn/current/properties.json file.

Steps to Upgrade Itential Software

To upgrade your core Pronghorn (IAP) software:

  1. Verify the latest version of Pronghorn (IAP) has been copied to the server. You can acquire the link for this build from the portal.

  2. The upgrade will capture your latest /opt/pronghorn/current/properties.json file and use it for your new installation.

  3. Change (cd) to the directory where the Pronghorn (IAP) install build (.bin) is stored.

  4. Shutdown Prongorn (IAP).

  5. Upgrade NodeJS to latest version of NodeJS 8 (refer to the nodejs.org website).

  6. Upgrade MongoDB to the latest certified version of MongoDB (refer to the Itential Minimum System Requirements).

    • Set feature compatibility version to 3.4 (refer to the recommended Itential configuration for Mongo setup or the docs.mongodb.com website).

  7. Run the following command to upgrade Pronghorn (add -v for verbose output).

    bash pronghorn-<build-id>.linux.x86_64.bin -p

Important Notes

  • Errors for adapter schema issues should be fixed in the properties.json file, or using the System > Adapters view.

  • During an upgrade, a database backup will be triggered via installer script. For instances where IAP is connected via SSL to a mongo database and mongo is configured with the requireSSL property, the backup may fail with the following message:

    Failed: error connecting to db server: no reachable servers.

  • A mongo database backup can be created using a mongodump command like this:

    sudo mongodump --ssl --db pronghorn --host $hostname --port 27017 --username $mongoUsername --password $MONGOPASS --sslCAFile $pathToCert

Restart IAP & Login

  1. Restart IAP after updating the properties.

  2. Login to verify the service is up.

  3. In the event you are unable to find old automations, tags, etc., run the migration script for the respective application and refresh IAP.

  4. For example, if you are not finding tags created on a previous version of IAP:

    • Locate the migration script for tags.

      cd
/opt/pronghorn/current/node_modules/@itential/tags/migration_scripts

    • Run the script.

      node migrateTagRefs.js

    • Refresh IAP.

  5. If you are still experiencing issues after running the migration script, please log a ticket with the Itential Service Desk. Be sure to provide all necessary information to reproduce the issue and one of our Customer Success Agents will help to address your issue.